home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat4 / ts.config.z / ts.config
Encoding:
Text File  |  2001-04-17  |  15.2 KB  |  331 lines
  1.  
  2.  
  3.  
  4. ttttssss....ccccoooonnnnffffiiiigggg((((4444))))                                                      ttttssss....ccccoooonnnnffffiiiigggg((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _tttt_ssss_...._cccc_oooo_nnnn_ffff_iiii_gggg - tape support configuration file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _////_eeee_tttt_cccc_////_cccc_oooo_nnnn_ffff_iiii_gggg_////_tttt_ssss_...._cccc_oooo_nnnn_ffff_iiii_gggg
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The tape support configuration file is _tttt_ssss_...._cccc_oooo_nnnn_ffff_iiii_gggg.  This file defines the
  16.      location of the personality-daemon binaries and the options available for
  17.      executing the _tttt_ssss_dddd_aaaa_eeee_mmmm_oooo_nnnn(1M) command.
  18.  
  19.      The tape support configuration file consists of statements and comments
  20.      (optional).  A comment begins with the # symbol and continues to the end
  21.      of line.  A statement consists of a name followed by a list of keyword
  22.      parameters.  The following statements are supported:
  23.  
  24.      +o    _PPPP_EEEE_RRRR_SSSS_OOOO_NNNN_AAAA_LLLL_IIII_TTTT_YYYY statements (one per personality daemon)
  25.  
  26.      +o    _OOOO_PPPP_TTTT_IIII_OOOO_NNNN_SSSS statement (one per system)
  27.  
  28.    SSSSttttaaaatttteeeemmmmeeeennnntttt SSSSyyyynnnnttttaaaaxxxx RRRRuuuulllleeeessss
  29.      The following syntax rules apply to _tttt_ssss_...._cccc_oooo_nnnn_ffff_iiii_gggg statements:
  30.  
  31.      +o    The statement name and its parameters are separated by one or more
  32.           white spaces (blank, tab, or newline characters).
  33.  
  34.      +o    Adjacent parameters are separated by a comma.
  35.  
  36.      +o    The end of the parameter list is indicated by the absence of a
  37.           comma.
  38.  
  39.      +o    Adjacent statements are separated by one or more white spaces.
  40.  
  41.      The following is a list of keyword parameter syntax rules:
  42.  
  43.      +o    The keyword is separated from its value by the _==== symbol.
  44.  
  45.      +o    The value of a keyword may consist of keywords, numbers, character
  46.           strings, and lists of keywords, numbers, and character strings.
  47.  
  48.      +o    If the value of a keyword is a list, the list is enclosed within
  49.           left and right parentheses.  Adjacent elements of a list are
  50.           separated by a comma.  If the list consists of one element, you do
  51.           not have to enclose it in parentheses.  The elements of a list may
  52.           be lists.
  53.  
  54.      +o    Numbers may be specified in decimal, octal, and hexadecimal formats.
  55.           These formats are the same as those used in the C programming
  56.           language:
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ttttssss....ccccoooonnnnffffiiiigggg((((4444))))                                                      ttttssss....ccccoooonnnnffffiiiigggg((((4444))))
  71.  
  72.  
  73.  
  74.           Decimal       First digit is not 0 (1372)
  75.           Octal         First digit is 0 (0563)
  76.           Hexadecimal   First 2 characters are either 0x or 0X (0xf2)
  77.  
  78.      +o    Character strings are series of characters.  If any one of the
  79.           special characters (white space, _"""", _####, _====, _{{{{, _}}}}, _((((, _)))), _'''', _\\\\) is
  80.           needed in the string, you must enclose the string in a pair of
  81.           double quotation marks (_"""").  Within a pair of double quotation
  82.           marks, the sequence of characters \_x is replaced by _x; _x is any
  83.           character.  This is the only way you can specify a _"""" and a _\\\\ in a
  84.           quoted string.
  85.  
  86.      +o    Comments may appear between any symbols described previously.
  87.  
  88.      You can code the names of statements and keywords in a mixture of
  89.      uppercase and lowercase letters.  The values specified by the user are
  90.      case sensitive.  The following values specify the same thing:
  91.  
  92.           Name = A
  93.           name = A
  94.  
  95.  
  96.      The following are different:
  97.  
  98.           name = A
  99.           name = a
  100.  
  101.  
  102.      The following are descriptions of the tape-support configuration
  103.      statements.  You must specify a value for each parameter unless a default
  104.      is specified or the parameter is described as optional.
  105.  
  106.    PPPPEEEERRRRSSSSOOOONNNNAAAALLLLIIIITTTTYYYY SSSSttttaaaatttteeeemmmmeeeennnntttt
  107.      The _PPPP_EEEE_RRRR_SSSS_OOOO_NNNN_AAAA_LLLL_IIII_TTTT_YYYY statement identifies the location of the personality-
  108.      daemon binary that supports devices having the specified vendor or
  109.      product identifier.
  110.  
  111.      The _PPPP_EEEE_RRRR_SSSS_OOOO_NNNN_AAAA_LLLL_IIII_TTTT_YYYY statement has the following format:
  112.  
  113.           PERSONALITY _p_a_r_a_m_e_t_e_r__l_i_s_t
  114.  
  115.  
  116.      A description of the parameters follows:
  117.  
  118.      _vvvv_eeee_nnnn_dddd_oooo_rrrr _==== _v_e_n_d_o_r
  119.           Specifies the vendor identifier of a device that the personality
  120.           daemon supports.  Use only the number of characters you wish to
  121.           compare with the vendor identifier returned by the device.
  122.  
  123.           You must specify either _pppp_rrrr_oooo_dddd_uuuu_cccc_tttt or _vvvv_eeee_nnnn_dddd_oooo_rrrr or both keyword
  124.           parameters.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ttttssss....ccccoooonnnnffffiiiigggg((((4444))))                                                      ttttssss....ccccoooonnnnffffiiiigggg((((4444))))
  137.  
  138.  
  139.  
  140.      _pppp_rrrr_oooo_dddd_uuuu_cccc_tttt _==== _p_r_o_d_u_c_t
  141.           Specifies the product identifier of a device that the personality
  142.           daemon supports.  Use only the number of characters you wish to
  143.           compare with the product identifier returned by the device.
  144.  
  145.           You must specify either _pppp_rrrr_oooo_dddd_uuuu_cccc_tttt or _vvvv_eeee_nnnn_dddd_oooo_rrrr or both keyword
  146.           parameters.
  147.  
  148.      _bbbb_iiii_nnnn_aaaa_rrrr_yyyy _==== _b_i_n_a_r_y
  149.           Specifies the pathname of the personality-daemon binary that
  150.           provides support for the device having the specified vendor or
  151.           product identifier.
  152.  
  153.           This parameter is mandatory.
  154.  
  155.    OOOOPPPPTTTTIIIIOOOONNNNSSSS SSSSttttaaaatttteeeemmmmeeeennnntttt
  156.      The _OOOO_PPPP_TTTT_IIII_OOOO_NNNN_SSSS statement specifies the _tttt_ssss_dddd_aaaa_eeee_mmmm_oooo_nnnn options.  It has the
  157.      following format:
  158.  
  159.      _OOOO_PPPP_TTTT_IIII_OOOO_NNNN_SSSS _p_a_r_a_m_e_t_e_r__l_i_s_t
  160.  
  161.      A description of the optional parameters follows:
  162.  
  163.      _tttt_rrrr_aaaa_cccc_eeee______ffff_iiii_llll_eeee______gggg_rrrr_oooo_uuuu_pppp______iiii_dddd _==== _i_d
  164.           Specifies the group identifier of the _tttt_ssss_dddd_aaaa_eeee_mmmm_oooo_nnnn trace files.
  165.           Default: 3
  166.  
  167.      _tttt_rrrr_aaaa_cccc_eeee______ffff_iiii_llll_eeee______mmmm_oooo_dddd_eeee _==== _m_o_d_e
  168.           Specifies the file mode of the _tttt_ssss_dddd_aaaa_eeee_mmmm_oooo_nnnn trace files.  Default: 0640
  169.  
  170.      _tttt_rrrr_aaaa_cccc_eeee______ffff_iiii_llll_eeee______oooo_wwww_nnnn_eeee_rrrr _==== _i_d
  171.           Specifies the owner identifier of the _tttt_ssss_dddd_aaaa_eeee_mmmm_oooo_nnnn trace files.
  172.           Default: 0
  173.  
  174.      _tttt_rrrr_aaaa_cccc_eeee______dddd_iiii_rrrr_eeee_cccc_tttt_oooo_rrrr_yyyy _==== _v_a_l_u_e
  175.           Specifies the _tttt_ssss_dddd_aaaa_eeee_mmmm_oooo_nnnn trace directory.  Default:
  176.           _////_vvvv_aaaa_rrrr_////_ssss_pppp_oooo_oooo_llll_////_tttt_ssss_////_tttt_rrrr_aaaa_cccc_eeee
  177.  
  178.      _tttt_rrrr_aaaa_cccc_eeee______ssss_tttt_aaaa_tttt_eeee _==== _v_a_l_u_e
  179.           Specifies whether _tttt_ssss_dddd_aaaa_eeee_mmmm_oooo_nnnn tracing is enabled.  _v_a_l_u_e is one of the
  180.           following:
  181.  
  182.           _OOOO_NNNN   Turns tracing on.
  183.  
  184.           _OOOO_FFFF_FFFF  Turns tracing off.  Default: _OOOO_FFFF_FFFF
  185.  
  186.           For more information on tracing, see the _tttt_ssss_dddd_aaaa_eeee_mmmm_oooo_nnnn(1M) man page.
  187.  
  188.      _tttt_rrrr_aaaa_cccc_eeee______ssss_aaaa_vvvv_eeee______dddd_iiii_rrrr_eeee_cccc_tttt_oooo_rrrr_yyyy _==== _v_a_l_u_e
  189.           Specifies where _tttt_ssss_dddd_aaaa_eeee_mmmm_oooo_nnnn traces should be saved.  Default:
  190.           _////_vvvv_aaaa_rrrr_////_ssss_pppp_oooo_oooo_llll_////_tttt_ssss_////_tttt_rrrr_aaaa_cccc_eeee_----
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ttttssss....ccccoooonnnnffffiiiigggg((((4444))))                                                      ttttssss....ccccoooonnnnffffiiiigggg((((4444))))
  203.  
  204.  
  205.  
  206.      _tttt_rrrr_aaaa_cccc_eeee______ffff_iiii_llll_eeee______ssss_iiii_zzzz_eeee _==== _s_i_z_e
  207.           Specifies the size (in bytes) of the _tttt_ssss_dddd_aaaa_eeee_mmmm_oooo_nnnn trace file.  This
  208.           parameter only applies to _CCCC_IIII_RRRR_CCCC_UUUU_LLLL_AAAA_RRRR trace files.  For more
  209.           information, see the _tttt_rrrr_aaaa_cccc_eeee______tttt_yyyy_pppp_eeee parameter.  Default: 409600
  210.  
  211.      _tttt_rrrr_aaaa_cccc_eeee______tttt_yyyy_pppp_eeee _==== _t_y_p_e
  212.           Specifies the _tttt_ssss_dddd_aaaa_eeee_mmmm_oooo_nnnn trace type.  _t_y_p_e is one of the following:
  213.  
  214.           _CCCC_IIII_RRRR_CCCC_UUUU_LLLL_AAAA_RRRR       Specifies overwriting existing trace information once
  215.                          the limit set in the _tttt_rrrr_aaaa_cccc_eeee______ffff_iiii_llll_eeee______ssss_iiii_zzzz_eeee parameter is
  216.                          reached.  Trace information is then output to the
  217.                          beginning of the file and the existing trace
  218.                          information is overwritten.
  219.  
  220.           _LLLL_IIII_NNNN_EEEE_AAAA_RRRR         Specifies writing trace information to the end of the
  221.                          file as there is no limit set on the file size.
  222.                          Default: _CCCC_IIII_RRRR_CCCC_UUUU_LLLL_AAAA_RRRR
  223.  
  224. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  225.      This example shows the sample tape support configuration file that is
  226.      shipped as _////_eeee_tttt_cccc_////_cccc_oooo_nnnn_ffff_iiii_gggg_////_tttt_ssss_...._cccc_oooo_nnnn_ffff_iiii_gggg.
  227.  
  228.           #
  229.           #  Copyright (C) 2000 Silicon Graphics, Inc.
  230.           #
  231.           #  These coded instructions, statements, and computer programs contain
  232.           #  unpublished proprietary information of Silicon Graphics, Inc., and
  233.           #  are protected by Federal copyright law. They may not be disclosed
  234.           #  to third parties or copied or duplicated in any form, in whole or
  235.           #  in part, without the prior written consent of Silicon Graphics, Inc.
  236.           #
  237.  
  238.           #
  239.           #       TAPE SUPPORT DAEMON CONFIGURATION FILE
  240.           #
  241.  
  242.           PERSONALITY
  243.                 vendor = STK ,
  244.                 product = SD-3 ,
  245.                 binary = /usr/etc/ts/tssd3
  246.  
  247.           PERSONALITY
  248.                 vendor = STK ,
  249.                 product = 9490 ,
  250.                 binary = /usr/etc/ts/ts9490
  251.  
  252.           #
  253.           #     /usr/etc/ts/ts9840 supports both 9840 and 9940.
  254.           #
  255.           PERSONALITY
  256.                 vendor = STK ,
  257.                 product = 9840 ,
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. ttttssss....ccccoooonnnnffffiiiigggg((((4444))))                                                      ttttssss....ccccoooonnnnffffiiiigggg((((4444))))
  269.  
  270.  
  271.  
  272.                 binary = /usr/etc/ts/ts9840
  273.  
  274.           PERSONALITY
  275.                 vendor = STK ,
  276.                 product = T9940A ,
  277.                 binary = /usr/etc/ts/ts9840
  278.  
  279.           PERSONALITY
  280.                 vendor = IBM ,
  281.                 product = 03590B1A ,
  282.                 binary = /usr/etc/ts/ts3590
  283.  
  284.           #
  285.           # /usr/etc/ts/tsdlt7000 supports both DLT7000 and DLT8000
  286.           #
  287.           PERSONALITY
  288.                 product = DLT7000 ,
  289.                 binary = /usr/etc/ts/tsdlt7000
  290.  
  291.           PERSONALITY
  292.                 product = DLT8000 ,
  293.                 binary = /usr/etc/ts/tsdlt7000
  294.  
  295.           OPTIONS
  296.           trace_file_group_id= 3 ,
  297.           trace_file_mode = 0640 ,
  298.           trace_file_owner= 0 ,
  299.           trace_directory= /var/spool/ts/trace ,
  300.           trace_state= ON ,
  301.           trace_save_directory= /var/spool/ts/trace- ,
  302.           trace_file_size = 409600 , trace_type= CIRCULAR
  303.  
  304.  
  305. FFFFIIIILLLLEEEESSSS
  306.      _////_eeee_tttt_cccc_////_cccc_oooo_nnnn_ffff_iiii_gggg_////_tttt_ssss_...._cccc_oooo_nnnn_ffff_iiii_gggg              tape support configuration file
  307.  
  308.      _////_vvvv_aaaa_rrrr_////_ssss_pppp_oooo_oooo_llll_////_tttt_ssss_////_tttt_rrrr_aaaa_cccc_eeee                trace directory
  309.  
  310. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  311.      tsarchive(1M), tsdaemon(1M), tserrpt(1M), tsset(1M), tsstop(1M), ts(7).
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.